Personsök

Tjänsten Personsök erbjuder direktåtkomst till SPAR för att aktualisera, komplettera och kontrollera personuppgifter.

Du kan söka efter personer både genom att ange personnummer eller samordningsnummer, eller genom att ange namn, adress, födelseintervall och en kombination av dessa.

När sökning görs med namn och adress utförs sökningen även mot historiska uppgifter tre år bakåt i tiden. Detta för att även omfatta personer som till exempel nyligen bytt namn eller flyttat under denna period.

Informationssäkerhet

När du ska behandla personuppgifter ur SPAR måste behandlingen ske i enlighet med reglerna i EU:s dataskyddsförordning. Det innebär bland annat att du måste ha kontroll på vem som får tillgång till personuppgifterna.

Ett exempel: Om en användare via internet får tillgång till personuppgifter ur SPAR, till exempel genom att användaren anger ett personnummer och får tillbaka adressen ur SPAR, måste användaren säkert kunna identifieras. Detta kan exempelvis ske genom att användaren identifierar sig med e-legitimation.

Om jämförelsen mellan inmatade uppgifter och uppgifter ur SPAR istället görs "i bakgrunden", utan att användaren får se uppgifterna, ställs inga krav på identifiering av användaren ur SPAR:s perspektiv.

Kom igång med tjänsten

Kommunikationen med Personsök bygger på SOAP-standarden vilken nyttjar XML-formatterade anrop och svar. Den senaste API-versionen av Personsök är 2023.1 och XML-scheman som beskriver den versionen finns under 2023.1.

Alla anrop kräver autentisering med klientcertifikat.

För testning bör du använda kundtestmiljön. I produktion nås tjänsten via adressen https://personsok.statenspersonadressregister.se/2023.1.

Vilken information du får tillbaka i svaren bestäms utifrån vilken behörighet din kundanvändare har i SPAR.

Nedan följer beskrivande exempel på anrop till Personsök i kundtestmiljön via programmet cURL. Samma anrop kan göras mot SPAR i produktion genom att byta ut adressen enligt ovan.

1. Hämta WSDL-fil

WSDL-filen beskriver programmatiskt API:et och kan användas för att generera kod för enklare integration med SPAR i ditt valda programmeringsspråk.

För att hämta filen gör följande anrop:

curl --cert-type P12 --cert <sökväg till certifikat från Expisoft>:<pin-kod> \
  https://test-personsok.statenspersonadressregister.se/2023.1/?wsdl

2. Sök med personnummer

För att söka en person med personnummer eller samordningsnummer gör följande anrop:

curl --cert-type P12 --cert <sökväg till certifikat från Expisoft>:<pin-kod> \
    -X POST -H 'Content-type: text/xml' -d @personnummer-sok.xml \
    https://test-personsok.statenspersonadressregister.se/2023.1

där personnummer-sok.xml är en fil med följande innehåll:

<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
  <Body>
    <SPARPersonsokningFraga xmlns="http://statenspersonadressregister.se/schema/personsok/2023.1/personsokningfraga">
      <Identifieringsinformation xmlns="http://statenspersonadressregister.se/schema/komponent/metadata/identifieringsinformationWs-1.1">
        <KundNrLeveransMottagare>500243</KundNrLeveransMottagare>
        <KundNrSlutkund>500243</KundNrSlutkund>
        <UppdragId>637</UppdragId>
        <SlutAnvandarId>Kundreferens - web-test</SlutAnvandarId>
      </Identifieringsinformation>
      <PersonsokningFraga xmlns="http://statenspersonadressregister.se/schema/komponent/sok/personsokningsokparametrar-1.2">
        <IdNummer xmlns="http://statenspersonadressregister.se/schema/komponent/person/person-1.3">195704133106</IdNummer> 
      </PersonsokningFraga>
    </SPARPersonsokningFraga>
  </Body>
</Envelope>

3. Sök med namn och adress

För att söka information om namn och adress gör följande anrop:

curl --cert-type P12 --cert <sökväg till certifikat från Expisoft>:<pin-kod> \
    -X POST -H 'Content-type: text/xml' -d @namn-adress-sok.xml \
    https://test-personsok.statenspersonadressregister.se/2023.1

där namn-adress-sok.xml är en fil med följande innehåll:

<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
  <Body>
    <SPARPersonsokningFraga xmlns="http://statenspersonadressregister.se/schema/personsok/2023.1/personsokningfraga">
      <Identifieringsinformation xmlns="http://statenspersonadressregister.se/schema/komponent/metadata/identifieringsinformationWs-1.1">
        <KundNrLeveransMottagare>500243</KundNrLeveransMottagare>
        <KundNrSlutkund>500243</KundNrSlutkund>
        <UppdragId>637</UppdragId>
        <SlutAnvandarId>Kundreferens - web-test</SlutAnvandarId>
      </Identifieringsinformation>
      <PersonsokningFraga
            xmlns="http://statenspersonadressregister.se/schema/komponent/sok/personsokningsokparametrar-1.2"
            xmlns:sok="http://statenspersonadressregister.se/schema/komponent/sok/sokargument-1.3">
        <sok:FornamnSokArgument>Susan</sok:FornamnSokArgument>
        <sok:MellanEfternamnSokArgument>Efternamn2052</sok:MellanEfternamnSokArgument>
        <sok:UtdelningsadressSokArgument>Gatan390 2</sok:UtdelningsadressSokArgument>
        <sok:PostortSokArgument>Gatan390 2</sok:PostortSokArgument>
      </PersonsokningFraga>
    </SPARPersonsokningFraga>
  </Body>
</Envelope>

Mer information

Alla sökparametrar och svarsattribut finns beskrivna i mer detalj i respektive XML-schema publicerat under 2023.1.

Ytterligare testfall för Personsök i kundtestmiljön finns beskrivna i nedan länkade dokument.

Relaterade dokument

Testfall För Personsökning I Kundtestmiljön